AirSim是一个基于虚幻引擎的无人机、汽车及其他交通工具的仿真模拟器。它是开源的、跨平台的,支持使用流行的飞行控制器进行软件在环仿真,以及硬件在环仿真,以实现物理和视觉上的逼真仿真。

安装虚幻引擎

  1. 下载 Epic Games Launcher 。虽然虚幻引擎是开源的,可以免费下载,但仍需要注册。
  2. 运行 Epic Games Launcher ,打开左侧窗格中的虚幻引擎选项卡。单击右上角的安装虚幻引擎按钮,该按钮应显示下载虚幻引擎 >= 4.25 的选项。选择适合您需求的安装位置。如果您安装了多个版本的虚幻版本,则通过单击该版本的启动按钮旁边的向下箭头,确保正在使用的版本设置为当前版本

注意: AirSim 也适用于 UE >= 4.22,但是,建议您更新到 >= 4.24。
注意:如果您有 UE 4.16 或更旧的项目,请参阅升级指南以升级您的项目。

虚幻引擎安装成功

构建 AirSim

  • 安装 Visual Studio 2019 。在安装 VS 2019 时请 确保勾选使用 C++ 的桌面开发和** Windows 10 SDK 10.0.18362 (应该为默认选择)。
    注意:可能还需要勾选
    .NET 桌面开发**,在后续的操作中避免缺少组件出现的错误。
  • 安装成功后,以管理员方式运行 Developer Command Prompt for VS 2019
  • 注意:可在开始菜单中搜索 Developer Command Prompt for VS 2019
  • 克隆存储库: git clone https://github.com/Microsoft/AirSim.git ,然后 cd AirSim 转到 AirSim 目录。
    **注意:**在 C 盘中安装 AirSim 通常不是个好主意。这可能会导致脚本失败,并且需要以管理员身份运行 VS 。而是在其他驱动器(如 D 或 E 盘)中克隆。
  • 在命令行执行 build.cmd 。这将在 Unreal\Plugins 文件夹中创建可使用并可拖入任何 Unreal Project 中的插件。

构建 Unreal Project

最后,您将需要一个 Unreal Project 为您的车辆承载环境。AirSim 附带一个内置的" Block 环境供您使用,或者您也可以创建自己的 Unreal Projec t。请参阅设置 Unreal Project
要快速熟悉并且运行,您可以使用 AirSim 附带的 Block 项目。为了保持仓库合理的大小,这并不是非常详细的环境,但这是最简单的方法去使用它的进行各种测试。
Block 环境可在仓库中获取,位于文件夹 UnReal/Environment/Block 中,并且设计为轻量级。这意味着它非常基础,但速度很快。以下是启动和运行Block环境的快速步骤:

  1. 确保已 安装并且构建 AirSim
  2. 定位到 AirSim\Unrea\Environments\Blocks 目录下并运行 update_from_git.bat
    注意:如果报错提示:系统找不到指定的路径; 不是内部或外部命令,也不是可运行的程序或批处理文件。解决方法:先重启 Epic Games Launcher ,重启后会弹出工程文件关联的提示。
  3. 双击生成的 .sln 文件以在 Visual Studio 2019 中打开。
  4. 在解决方案资源管理器中右击 Block 项目,选择设为启动项目,选中 Block 项目,打开生成里的配置管理器配置选择 Development_Editor平台选择x64 ,点击调试里的开始调试(或者按 F5 ),此时应该自动打开虚幻编辑器。
    配置管理器
  5. 点击虚幻编辑器里上方的运行按钮,进入游戏状态,如果想用四旋翼飞行器,就在弹出的对话框中点击 no ,如果想用小车,点击的 Yes ,你会看见如下图的场景。
    虚幻编辑器

如何使用 AirSim

通过执行上述步骤设置 AirSim 后,您可以,

  1. Unreal\Environments\Blocks目录下双击 .sln 文件,加载 Block 项目(或您自己的创建的虚幻项目)。如果您没有看到 .sln 文件,则可能尚未完成上述**构建 Unreal Project **部分中的步骤。
  2. 选择您的 Unreal Project 作为启动项目(例如, Block 项目),并确保生成配置设置为Development_Editor平台选择x64
  3. 加载虚幻编辑器后,点击运行按钮。
    提示:点击菜单栏里的编辑,点击编辑器偏好设置,在搜索框中输入 CPU ,取消勾选处于背景时占用较少CPU
    编辑器偏好设置

请参阅 使用 APIssettings.json供更多选择。

使用 Python 控制

提示:请提前安装好 Anaconda3 和 pip 。

  1. 以管理员身份运行 cmd ,执行 pip install airsim ,该命令安装了囊括 Python API for AirSim 的 Python 包。该包依赖 msgpack 包并且会自动安装 msgpack-rpc-python 包,(可能需要管理员或者 sudo 权限)。
    注意:有的例子还需要 opencv 包。
  2. \PythonClient\car 目录下,使用 cmd 执行 python hello_car.py ,便能看到小车根据 Python 文件中编写好的命令自动运行了!
      Python 控制小车

Enjoy🎉

参考资料

Build AirSim on Windows
airsim · PyPI
win10-airsim-Unreal 安装配置教程(踩坑)